Skip to content

docs: Modify installation instruction for dependencies#42

Merged
sbillinge merged 3 commits intoPDF-bl:mainfrom
ycexiao:installation-instruction
Feb 19, 2026
Merged

docs: Modify installation instruction for dependencies#42
sbillinge merged 3 commits intoPDF-bl:mainfrom
ycexiao:installation-instruction

Conversation

@ycexiao
Copy link
Contributor

@ycexiao ycexiao commented Feb 18, 2026

What problem does this PR address?

Closes #41

What should the reviewer(s) do?

Please check the installation instructions.

@codecov
Copy link

codecov bot commented Feb 18, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@ycexiao ycexiao marked this pull request as ready for review February 18, 2026 16:58
@ycexiao
Copy link
Contributor Author

ycexiao commented Feb 18, 2026

@sbillinge, it's ready for review.

Copy link
Contributor

@sbillinge sbillinge left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pls see comment

README.rst Outdated

But then you need to install its dependencies manually. Use the following commands ::

wget https://raw.githubusercontent.com/PDF-bl/pdfbl.sequential/main/requirements/conda.txt
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This will only work on Linux and Mac. This may be ok, but let's make that decision explicitly. Do we ever envisage users installing this on their local computers?

Copy link
Contributor Author

@ycexiao ycexiao Feb 18, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did this because I think letting conda.txt be installed before feeding it to conda install --file gives the user the option to examine its contents before running the command.

But now you mentioned that wget is not available in Windows by default, and I realized that only diffpy.cmi needs to be installed from conda, I'm thinking about changing it into:

But then you need to install its dependency `diffpy.cmi` manually. Run the command::

     conda install diffpy.cmi

What do you think about it?

Copy link
Contributor Author

@ycexiao ycexiao left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sbillinge, it's ready for review.

README.rst Outdated

pip install pdfbl.sequential

But then you need to install its dependency `diffpy.cmi` manually. Run the command::
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The installation instructions have been updated per the comment.

README.rst Outdated

pip install pdfbl.sequential

But then you need to install its dependency `diffpy.cmi` manually. Run the command::
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

isn't it better to install this before pip installing pdfbl.sequential so there aren't lots of scary messages about dependencies not building properly?

Copy link
Contributor Author

@ycexiao ycexiao left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sbillinge, it's ready for review.

If the above does not work, you can use ``pip`` to download and install the latest release from
`Python Package Index <https://pypi.python.org>`_.
To install using ``pip`` into your ``pdfbl.sequential_env`` environment, type ::
You can also use ``pip`` to download and install the latest release from
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Install diffpy.cmi dependency first.

@sbillinge sbillinge merged commit 25cc4f9 into PDF-bl:main Feb 19, 2026
6 checks passed
@ycexiao ycexiao deleted the installation-instruction branch February 23, 2026 17:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: diffpy.cmi should not be installed from PyPI

2 participants